| Property | Type | Access | Description |
|---|
| alignChildren | String |
r/w | Specifies how to align the child elements. |
| alignment | String |
r/w |
The alignment style for this element. If defined, this value overrides the alignChildren setting for the parent container.
This can be a single string, which indicates the alignment for the orientation specified in the parent container, or an array of two strings, indicating both the horizontal and vertical alignment (in that order). Allowed values depend on the orientation value of the parent container. They are not case sensitive.
•
For orientation=row:top, bottom, fill
•
For orientation=column: left, right, fill
•
For orientation=stack:top, bottom, left, right, fill
|
| bounds | Bounds |
r/w | The boundaries of the element, in parent-relative coordinates.
Setting an element's size or location changes its bounds property, and vice-versa. |
| characters | Number (min: 0) |
r/w |
Reserve space for the specified number of characters; affects calculation of preferredSize .
|
| children | Array of Object |
readonly | An array of child elements. |
| enabled | Boolean |
r/w | True if this element is enabled.
An enabled element can accept input, according to its type. When false, control elements do not accept input, and all types of elements have a dimmed appearance. |
| graphics | ScriptUIGraphics |
readonly |
The graphics object that can be used to customize the element's appearance, in response to the onDraw() event.
|
| helpTip | String |
r/w | The help text that is displayed when the mouse hovers over the element. |
| indent | Number (min: 0) |
r/w | The number of pixels to indent the element during automatic layout.
Applies for column orientation and left alignment, or row orientation and top alignment. |
| justify | String |
r/w | The default text justification style for child text elements. (default: left)
One of left, center, or right. Justification only works if this value is set on creation of the element.
|
| layout | LayoutManager |
r/w | The layout manager for this container.
The first time a container object is made visible, ScriptUI invokes this layout manager by calling its layout() function. Default is an instance of the LayoutManager class that is automatically created when the container element is created.
|
| location | Point |
r/w | The upper left corner of this element's frame relative to its parent.
The location is defined as [bounds.x, bounds.y]. Setting an element's location changes its bounds property, and vice-versa. |
| margins | Number |
r/w | The number of pixels between the edges of a container and the outermost child elements.
You can specify different margins for each edge of the container. The default value is based on the type of container, and is chosen to match the standard Adobe UI guidelines. |
| maximumSize | Dimension |
r/w | The maximum height and width to which the element can be resized. |
| minimumSize | Dimension |
r/w | The minimum height and width to which the element can be resized. |
| orientation | String |
r/w | The layout orientation of children in a container.
Interpreted by the layout manager for the container. The default LayoutManager Object accepts the (case-insensitive) values row, column, or stack. For window and panel, the default is column, and for group the default is row. The allowed values for the container's alignChildren and its children's alignment properties depend on the orientation.
|
| parent | Object |
readonly | The parent element. |
| preferredSize | Dimension |
r/w | The preferred size, used by layout managers to determine the best size for each element.
If not explicitly set by a script, value is established by the UI framework in which ScriptUI is employed, and is based on such attributes of the element as its text, font, font size, icon size, and other UI framework-specific attributes.A script can explicitly set this value before the layout manager is invoked in order to establish an element size other than the default. |
| properties | Object |
r/w | An object that contains one or more creation properties of the control (properties used only when the element is created).
Creation properties of a Panel object can include:
•
borderStyle: A string that specifies the appearance of the border drawn around the panel. One of black, etched, gray, raised, sunken. Default is etched.
•
su1PanelCoordinates: Photoshop only. When true, this panel automatically adjusts the positions of its children for compatability with Photoshop CS. Default is false, meaning that the panel does not adjust the positions of its children, even if the parent window has automatic adjustment enabled.
|
| size | Dimension |
r/w | The current dimensions of this element.
Initially undefined, and unless explicitly set by a script, it is defined by a LayoutManager . A script can explicitly set size before the layout manager is invoked to establish an element size other than the preferredSize or the default size, but this is not recommended. Defined as [bounds.width, bounds.height]. Setting an element's size changes its bounds property, and vice-versa.
|
| spacing | Number |
r/w | The number of pixels separating one child element from its adjacent sibling element.
Because each container holds only a single row or column of children, only a single spacing value is needed for a container. The default value is based on the type of container, and is chosen to match standard Adobe UI guidelines. |
| text | String |
r/w | The title or label text, a localizable string. |
| type | String |
readonly | The element type; "panel". |
| visible | Boolean |
r/w | True if this element is shown, false if it is hidden.
When a container is hidden, its children are also hidden, but they retain their own visibility values, and are shown or hidden accordingly when the parent is next shown. |
| window | Window (SUI) |
readonly | The window that this element belongs to. |
| windowBounds | Bounds |
readonly | The bounds of this element relative to the top-level parent window. |